home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Selection / Multimedia Selection Volume One - CD-ROM / MULTIMEDIA SELECTION____________.ISO / utils / s3tool10 / log30.doc < prev    next >
Encoding:
Text File  |  1991-10-15  |  4.1 KB  |  110 lines
  1.                           LOGit v3.0
  2.                               By
  3.                         George Spafford
  4.  
  5.                         October 15, 1991
  6.                         
  7. Purpose:
  8.  
  9. To allow a user to insert a command in a batch file and thus log the
  10. activity to a log file of their choice WITH a comment of their choice,
  11. the date and the time.  The program must also be readily adaptable for any 
  12. use, be it BBS, corporate or home.
  13.  
  14. Procedure:
  15.  
  16. To run LOGit, it has the following command line switches:
  17.  
  18.        LOGit /c:my_comment /l:c:\dir\myname.log
  19.        
  20.        /C:   Okay, this is the comment that you wish to have appended in
  21.              your log file.  Note the underscore (_).  It is used on the command
  22.              line to indicate that you would like the comment to have a space
  23.              in that position.  So, when you look at the log file that the
  24.              above entry would create, it would look like  "MY COMMENT:"
  25.              LOGit changes all text to upper-case and it adds the colon to the
  26.              end of the text.  You can omit this entry if you so desire.
  27.              
  28.        /L:   This is the name of the log file that you would like the log entry
  29.              to be appended to.  This can include the drive and path.
  30.              For example:  LOGit /C:Hiya_activated /L:c:\Hiya.log
  31.              You can use any naming scheme you want.
  32.  
  33.        /?    This brings up a quick help screen.
  34.              
  35. Suggestions:
  36.  
  37. With the comments, you can enter descriptive terms for your log file.  For 
  38. example, in your controlling batch file you might have:
  39.  
  40.         @echo off
  41.         cls
  42.         Echo Now Loading Data Files
  43.         Logit /c:Data_load_started /l:project.log
  44.         process.exe mydata.txt
  45.         logit /c:initial_process_completed /l:project.log
  46.         sort mydata.txt
  47.         logit /c:sort_completed /l:project.log
  48.         import mydata.txt
  49.         logit /c:import_complete /l:project.log
  50.  
  51.         
  52. In your log file, the following would be appended (with the appropriate time
  53. and date):
  54.  
  55.         10-14-91  13:55:55 :  DATA LOAD STARTED
  56.         10-14-91  14:00:00 :  INITIAL PROCESS COMPLETED
  57.         10-14-91  14:05:00 :  SORT COMPLETED
  58.         10-14-91  14:15:00 :  IMPORT COMPLETED
  59.         
  60. To clean a log up, you might want to put an extra LOGit at the end with a 
  61. comment like:  /C:------------------------------------------.
  62. It gives a readily identifiable separator (It will also have a date
  63. and time added to it - just food for thought).
  64.  
  65. History:
  66.  
  67.    10/15/91  v3.0
  68.  
  69.    Corrected a bug that conflicted with the use of a carat "^" on the
  70.    command line with some versions of DOS.  An underscore character
  71.    is now used in its place as a space holder.
  72.  
  73.    Also changed the log entry order to:
  74.    DATE   TIME :  Comment
  75.    This helped to line the entries up & thus make the log easier to read.
  76.  
  77.    10/01/91  v2.0
  78.  
  79.    Added user definable log comments using the /C: switch.
  80.  
  81.  
  82.  
  83. --------------------------------------------------------------------------
  84.  
  85. I hope this program helps you evaluate some of your problems
  86. or even makes some solutions/benefits clear.  This program is
  87. released as shareware.  Its price is $5 for each concurrently
  88. used copy.  If you have any suggestions or comments, I'd REALLY
  89. like to hear those too.
  90.  
  91.                 Sincerely,
  92.  
  93.                 George Spafford
  94.                 3001 LakeShore Drive, #329
  95.                 St. Joseph, MI 49085
  96.  
  97. Data:  (616) 468-5026  Queued Access BBS 14.4Kb USR Dual HST
  98.                        FIDOnet: 1:227/250
  99.  
  100.  
  101. LOGit IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES NO
  102. WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
  103. TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE,
  104. WITH RESPECT TO THIS SOFTWARE AND DOCUMENTATION. IN NO EVENT SHALL
  105. THE AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST
  106. SAVINGS, OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  107. OUT OF THE USE OF OR THE INABILITY TO USE THIS PROGRAM.
  108. -------------------------------------------------------------------------
  109.  
  110.